home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / B / BB05.cpt / Batch Binary Docs next >
Text File  |  1989-05-14  |  6KB  |  102 lines
  1. Batch MacBinary Version 0.5 Documentation
  2.  
  3. What is MacBinary?
  4.  
  5. MacBinary is a file format that is used in cases where it is necessary to store Macintosh files on
  6. other computing systems, such as MS-DOS machines. The need for this file format arises from the fact
  7. that many Macintosh files consist of two extents, the resource and data forks, and contain information
  8. such as the creator and type. This type of file structure is unique to the Macintosh environment, and
  9. is not supported by other file systems. To prevent loss of information when transferring files to
  10. other operating environments, the MacBinary format was devised. Simply, it packages the type and
  11. creator information into a header, and the resource and data forks into a single extent. The resulting
  12. file can be stored on many hardware platforms, and easily converted back into a Macintosh format file.
  13.  
  14. MacBinary was developed primarily for use with telecommunications programs; currently all popular
  15. Macintosh terminal programs incorporate MacBinary processing as a more-or-less transparent part of
  16. their file transfer operations.
  17.  
  18. But there is a "gotcha". Files existing in MacBinary format, when transferred to a Macintosh platform
  19. by means such as a TOPS network, or use of the Apple File Exchange software in conjunction with an
  20. Apple SuperDrive, or any other file transfer protocol that does not incorporate MacBinary translation
  21. remain in MacBinary format, which is essentially unusable by the Macintosh. Currently there exists
  22. one, and only one method to perform this translation ad hoc, that being the BinHex 5 utility written
  23. several years ago by Yves Lempereur. This utility works well, and should be part of everyone's
  24. software library.
  25.  
  26. However, in these days of interoperability, the common use of Macintosh computers in formerly
  27. true-blue shops, and common operation of Mac oriented BBS's on MS-DOS and other computer platforms,
  28. and the advances made in Macintosh performance over the past couple of years, there is obviously a
  29. severe limitation to a tool like BinHex 5. It performs one, and only one file translation at a time.
  30. For a BBS operator trying to maintain a virus-free library of thousands of files on a non-Macintosh
  31. platform, this is intolerable. Léo Laporte found this out during the operation of his late, lamented
  32. MacQ BBS (one of the finest BBS's, and sysops ever to grace Fidonet) and started construction of a
  33. batch MacBinary utility. Unfortunately he never finished the project. 
  34.  
  35. This program is what Léo envisioned.
  36.  
  37. What does Batch MacBinary do?
  38.  
  39. Simply, Batch MacBinary takes a folder containing several files in MacBinary format, and converts them
  40. all to native Macintosh format in one quick step. Operation of the program is simple in the extreme.
  41. Just pull down the appropriate selection from the Conversion menu, and select any file from the folder
  42. that you wish converted. All the MacBinary files in the folder will be converted to native Mac format.
  43. This includes text files, which will have linefeeds and other gremlins zapped. Be careful not to
  44. convert PC based Arc, Zip etc. files. This process will corrupt them.
  45.  
  46. Caveats:
  47.  
  48. This program is in it's first release, and has not been tested in depth. If you have problems with it,
  49. please let me know. As far as I know it should run on all Macs, but there is a possibility that it
  50. might not run under MFS.
  51.  
  52. Since the program works by loading the entire resource and data forks into RAM at once (giving it it's
  53. excellent speed) you may find that you need to increase it's default memory allocation under
  54. Multifinder to process large files. If you have file sizes much about 900K or so, you may find that
  55. you need to use BinHex5 for these jumbos.
  56.  
  57. Two types of errors are most likely; skipping a file that was intended to be converted, and attempting
  58. to convert a file that is not MacBinary. The former is most likely to occur if you have more than 1024
  59. files in your conversion folder. I you notice either type of problem, let me know. If it is a case of
  60. non-Macbinary files being converted, please inform me so I can beef up the MacBinary detection
  61. routine.
  62.  
  63. License:
  64.  
  65. This program is free to individuals operating in a non-commercial environment, or in association with
  66. a BBS that does not charge any access fees. If you generate income in any fashion associated with the use
  67. of this program, you are expected to pay a registration fee.
  68.  
  69. This program may be freely distibuted by any manner, so long as this documentation and the program are
  70. distributed together, unaltered. Fees above normal connect time, disk and mailing costs may not be
  71. charged.
  72.  
  73. Organizations making a profit from the distribution of shareware and public domain software must write
  74. to the address below to obtain a license to distribute this software.
  75.  
  76. A $25 per copy in use registration fee is required from those using this program in any way associated with a
  77. commercial, profit or non-profit, or governmental operations, or a BBS or other information 
  78. provider that charges membership or access fees of any sort.
  79.  
  80. This program, with the exception of the source code provided by Leo Laporte, is Copyright 1989 by Eric
  81. Larson. All rights except those expressly provided for above are reserved.
  82.  
  83. Registration fees and bug reports should be sent to:
  84.  
  85. Eric Larson 
  86. 2902 Falls Road 
  87. Marcellus, NY 13108 USA 
  88. Fidonet 1:260/330.0
  89.  
  90. Planned future enhancements:
  91.  
  92. Version 1.0 will contain a MacBinary encoding routine.
  93.  
  94. Enhanced Multifinder friendliness and MacBinary II may be added in the future.
  95.  
  96. Warranty:
  97.  
  98. There is no warranty of merchantability or fitness for any use. No liability for direct, indirect,
  99. special or consequential damages, or loss of data, revenue or use is assumed. Determination for
  100. fitness in a given application lies solely with the user.
  101.  
  102.